Inside Macintosh: QuickDraw GX Graphics /

Chapter 2 - Geometric Shapes / Geometric Shapes Reference

Functions / Getting and Setting Shape Geometries

GXSetPaths

You can use the GXSetPaths function to change the geometry of a path shape.

void GXSetPaths(gxShape target, const gxPaths *data);

target

A reference to the path shape whose geometry you want to change.

data

A pointer to new path geometry.

DESCRIPTION

The GXSetPaths function copies the geometry information from the data parameter into the geometry property of the target path shape. If the target shape is not a path shape, this function posts the error code illegal_type_for_shape.

You must provide a pointer to a gxPaths structure in the data parameter--if you pass nil for this parameter, the function posts the error code parameter_is_nil.

If the target shape is locked (that is, its gxLockedShape shape attribute is set), this function posts the error shape_access_not_allowed.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
number_of_points_exceeds_implementation_limit
number_of_contours_exceeds_implementation_limit
size_of_path_exceeds_implementation_limit
count_is_less_than_one	(debugging version)
shape_access_not_allowed	(debugging version)

SEE ALSO

For general information about path geometries, see "Path Shapes" on page 2-25.

For the definition of the gxPaths structure, see page 2-107.

To create a new path shape, use the GXNewPaths function, which is described on page 2-117.

To examine the geometry of an existing path shape, use the GXGetPaths function, which is described on page 2-132.

To draw a path geometry without creating a path shape, use the GXDrawPaths function, which is described on page 2-162. To draw a path shape, use the GXDrawShape function, which is described in the chapter "Shape Objects" in Inside Macintosh: QuickDraw GX Objects.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help